home *** CD-ROM | disk | FTP | other *** search
/ DOpus Plus / DOpus Plus.iso / SDK / docs / diskio.doc < prev    next >
Encoding:
Text File  |  1998-10-26  |  2.3 KB  |  78 lines
  1. dopus5.library/OpenDisk                               dopus5.library/OpenDisk
  2.  
  3.     NAME
  4.         OpenDisk - open a disk for direct I/O
  5.  
  6.     SYNOPSIS
  7.         OpenDisk(disk, port)
  8.                   A0    A1
  9.  
  10.         DiskHandle *OpenDisk(char *, struct MsgPort *);
  11.  
  12.     FUNCTION
  13.         This routine makes it easy to access the underlying device for
  14.         direct I/O. It allows you to open any filesystem (that supports
  15.         direct I/O) with just the device name.
  16.  
  17.     INPUTS
  18.         disk - name of disk to open, eg DF0:, HD1:
  19.         port - message port to use, or NULL
  20.  
  21.     RESULT
  22.         If this function succeeds, it returns a DiskHandle structure,
  23.         which contains all the information you need to access the device
  24.         directly. The structure fields are :
  25.  
  26.             dh_Port
  27.                 If you did not supply a message port to use, one is
  28.                 created automatically and its address is stored here. Usually
  29.                 you will want a port created for you, but if you are working
  30.                 with multiple devices at once you might want them all to share
  31.                 the same message port.
  32.  
  33.             dh_IO
  34.                 This is a pointer to an IOExtTD structure, which you can use
  35.                 to perform I/O on the device.
  36.  
  37.             dh_Startup
  38.                 A pointer to the FileSysStartupMsg of the device.
  39.  
  40.             dh_Geo
  41.                 A pointer to the DosEnvec structure of the device.
  42.  
  43.             dh_Device
  44.                 Full device name (without a colon)
  45.  
  46.             dh_Info/dh_Result
  47.                 If dh_Result is TRUE, dh_Info is valid, and contains current
  48.                 information about the disk.
  49.  
  50.             dh_Root/dh_BlockSize
  51.                 These give the block number of the disk's root block, and
  52.                 the block size.
  53.  
  54.     SEE ALSO
  55.         CloseDisk(), trackdisk.doc
  56.  
  57. dopus5.library/CloseDisk                             dopus5.library/CloseDisk
  58.  
  59.     NAME
  60.         CloseDisk - close a DiskHandle structure
  61.  
  62.     SYNOPSIS
  63.         CloseDisk(handle)
  64.                     A0
  65.  
  66.         void CloseDisk(DiskHandle *);
  67.  
  68.     FUNCTION
  69.         This function cleans up and closes a DiskHandle structure opened
  70.         with the OpenDisk() routine.
  71.  
  72.     INPUTS
  73.         handle - DiskHandle to close
  74.  
  75.     SEE ALSO
  76.         OpenDisk()
  77.  
  78.